package com.yc.cloud.admin.service;

import com.yc.cloud.common.orm.CommonPage;
import com.yc.cloud.common.basic.dto.BasePageReqDTO;
import com.yc.cloud.admin.dto.request.HwCameraSnapshotRecordCreateReqDTO;
import com.yc.cloud.admin.dto.request.HwCameraSnapshotRecordUpdateReqDTO;
import com.yc.cloud.admin.dto.request.HwCameraSnapshotRecordPageReqDto;
import com.yc.cloud.admin.vo.HwCameraSnapshotRecordVo;
import com.yc.cloud.entity.HwCameraSnapshotRecord;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

/**
 * <p>
 * 摄像头抓图记录表 服务类
 * </p>
 *
 * @author kinggu
 * @since 2025-10-10
 */
public interface HwCameraSnapshotRecordService extends IService<HwCameraSnapshotRecord> {

    /**
     * 创建摄像头抓图记录表
     * @param createReqDTO 创建参数
     * @return 创建成功后的VO对象
     */
    HwCameraSnapshotRecordVo create(HwCameraSnapshotRecordCreateReqDTO createReqDTO);

    /**
     * 更新摄像头抓图记录表
     * @param updateReqDTO 更新参数
     * @return 更新成功后的VO对象
     */
    HwCameraSnapshotRecordVo update(HwCameraSnapshotRecordUpdateReqDTO updateReqDTO);

    /**
     * 分页查询摄像头抓图记录（支持摄像头ID和日期范围过滤）
     * @param pageReqDTO 查询参数
     * @return 分页结果
     */
    CommonPage<HwCameraSnapshotRecordVo> list(HwCameraSnapshotRecordPageReqDto pageReqDTO);

    /**
     * 分页查询摄像头抓图记录（基础版本，保持向后兼容）
     * @param pageReqDTO 基础查询参数
     * @return 分页结果
     * @deprecated 建议使用 {@link #list(HwCameraSnapshotRecordPageReqDto)}
     */
    @Deprecated
    CommonPage<HwCameraSnapshotRecordVo> list(BasePageReqDTO pageReqDTO);

    HwCameraSnapshotRecordVo getVOById(Long id);

    List<HwCameraSnapshotRecordVo> convertToVoList(List<HwCameraSnapshotRecord> entityList);

    HwCameraSnapshotRecord get(Long id);

    boolean delete(Long id);
} 